pp108 : Setting Synchronized Dialogs

Setting Synchronized Dialogs

This topic describes the procedure to create synchronized dialogs for a Table control.

Before you begin this task:
Ensure that the XForm to be specified as the synchronized dialog is published to run time.

In XForms where you need to display data in multiple fields of a Table control, the user interface may look cluttered and become difficult to navigate. To avoid this, you can structure the Table control to display only the essential information and use synchronized dialogs to display the details of each record in the Table control.

Synchronized dialogs are XForms that are invoked on clicking a record in a table. Before specifying synchronized dialogs, you must create the XForm containing the relevant fields and publish it.

  1. Open the XForm in the XForms Designer.
  2. Right-click the Table control in the XForm, and select Properties. Alternatively, double-click the control. The Table window appears in the XForms Designer.
  3. Click Synchronized Dialog Options to expand the pane. It displays various options to specify the synchronized dialog.
  4. Type the URL of the XForm to be used as the synchronized dialog in the Dialog URL field. Alternatively, click to open the Select URL dialog box, select an XForm, and click OK. The URL of the XForm displays in the Dialog URL field.
  5. Select an option from the On Dialog Open drop-down list to specify the event handlerto be executed before opening the synchronized dialog. Alternatively, click to open the Script Editor and specify the event handler programmatically. The specified event handler is displayed in the On Dialog Open drop-down list.
  6. Click Dialog Properties to expand the pane, and make appropriate modifications:
    • Type a unique ID in the ID field for identifying and referring the synchronized dialog.
    • Type the text to be displayed in the XForm's titlebar and tabcaption in the Caption field.
    • Type the text to be displayed in the XForm's titlebar and as the XForm name in the navigational tree in the Description field.

      Note:
      If the Dialog Caption and Dialog Description are different, both display in the titlebar as <dialog caption> - <dialog description>. If same, only the Dialog Caption is displayed, and the text is not repeated in the titlebar.

    • Check Docked to specify whether the synchronized dialog must be docked in the Process Platform Classic view.
    • Type an integer value in the Left field to specify the position of the left edge of the synchronized dialog.
    • Type an integer value in the Top field to specify the position of the top edge of the synchronized dialog.
    • Type an integer value in the Width field to specify the width of the synchronized dialog.
    • Type an integer value in the Height field to specify the height of the synchronized dialog.

      Note:
      The unit for the values that you enter in the Left, Top, Width, and Height fields is taken as px (pixel), by default. Also, these options are available only if the synchronized dialog is specified as undocked.

  7. Click .

This saves the settings specified for the synchronized dialog for the XForm.

CAUTION
Ensure that the XForms used to create synchronized dialogs contain models with common business objects. In case of XForms created using Process Platform operators, the operators must belong to the same Web service interface.

Restriction

  • In case of synchronized dialogs for which both the XForms contain tables, the synchronization of data between the tables is not supported.
  • The synchronized dialogs feature is not supported for non-transactional models.